home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1993…ch: Other People's Memory / ADC Developer CD (1993-03) (''Other People's Memory'')_iso / Dev.CD Mar 93.iso / Development Platforms / Apple II / Essentials / Technical.Notes / IIGS / TN.IIGS.100 < prev    next >
Encoding:
Text File  |  1992-07-15  |  10.8 KB  |  251 lines  |  [TEXT/GEOL]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5. Apple IIgs
  6. #100: VersionVille
  7.  
  8. Revised by: Matt Deatherage                                          May 1992
  9. Written by: Matt Deatherage                                      January 1991
  10.  
  11. This Technical Note is all there is to know about versions, version formats
  12. and version numbers on the Apple IIgs.
  13.  
  14. CHANGES SINCE JANUARY 1991:  Revised to include System Software 6.0.
  15. _____________________________________________________________________________
  16.  
  17.  
  18. VERSION NUMBER FORMATS
  19.  
  20. There are three kinds of version numbers on the Apple IIgs.  Two of the three
  21. are documented elsewhere but are repeated here for convenience.
  22.  
  23. SYSTEM TOOL SET VERSIONS
  24.  
  25. The Apple IIgs system tools use a one-word version number.  The high-order
  26. four bits of this word have special meaning.  Bits 8-11 are the major version
  27. number and bits 0-7 are the minor version number.  This is illustrated in
  28. Figure 1.
  29.  
  30.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  31.               | F| E| D| C| B| A| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
  32.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  33.                 |  |_____||   Major   |        Minor          |
  34.                 |     |   |  Release  |       Release         |
  35.                 |     |   |___________|_______________________|
  36.                 |     |
  37.                 |     +---- 1 = Special Features
  38.                 +---------- 1 = Prototype
  39.  
  40.  
  41.                         Figure 1-Toolbox Version Numbers
  42.  
  43. Note that this definition is different and supersedes the definition in the
  44. Apple IIgs Toolbox Reference for system tool sets.  Previous documentation
  45. reserves only bit 15 as the prototype bit; this has been expanded.  Bits 14-12
  46. of user tool set version words have no special meaning; they are still part of
  47. the major release.
  48.  
  49.    NOTE : When comparing the major and minor release version
  50.           numbers to check the installed version of a system tool,
  51.           mask off bits 15-12 first (for example, by using an AND
  52.           #$0FFF instruction).
  53.  
  54.  
  55. SMARTPORT OR GS/OS DRIVER VERSIONS
  56.  
  57. GS/OS drivers and SmartPort firmware drivers use an alternate one-word version
  58. number, described in Figure 2.
  59.  
  60.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  61.               | F| E| D| C| B| A| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
  62.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  63.               |___________|_______________________|___________|
  64.                   Major             Minor          $A = Alpha
  65.                  Release           Release         $B = Beta
  66.                                                    $E = Experimental
  67.                                                    $0 = Final
  68.  
  69.  
  70.              Figure 2--GS/OS Driver And SmartPort Version Numbers
  71.  
  72. APPLE IIGS LONG VERSION FORMAT
  73.  
  74. Long version format is a 32-bit (two-word) format similar to the standard
  75. Macintosh version numbering scheme defined in Macintosh Technical Note #189,
  76. Version Territory, except the four bytes are stored least significant byte
  77. first, as is standard on the Apple II, and the values of the stage are
  78. different.  Figure 3 shows the format of a long version.
  79.  
  80.  
  81.                High word
  82. +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  83. |1F|1E|1D|1C|1B|1A|19|18|17|16|15|14|13|12|11|10| ...
  84. +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  85. |     Major version     | Minor v.  | Bug vers. |
  86. +-----------------------+-----------+-----------+
  87.  Major version          |Minor      | Bug version
  88.  (2 digits, BCD)        |version (1 | (2 digits, BCD)
  89.  Example:               |digit, BCD)| Example:
  90.  $25 = Version 25       |Example:   | $4 = Version
  91.                         |$0 = Vers. | x.y.4
  92.                          x.0
  93.                                                   Low word
  94.                             +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  95.                         ... | F| E| D| C| B| A| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
  96.                             +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  97.                             | Stage  | Must be zero |     Release version   |
  98.                             +--------+--------------+-----------------------+
  99.                       Stage:         |              | Release version (2
  100.                       001 = develop  |              | digits, BCD)
  101.                       010 = alpha    |              | Example:
  102.                       011 = beta     |              | Long version value of
  103.                       100 = final    |              | $25048006 = Version
  104.                       110 = release                   25.0.4f6
  105.  
  106.                          Figure 3-Long Version Numbers
  107.  
  108.  
  109. Long version format allows for bug versions, unlike toolbox versions.  Also,
  110. you can do unsigned long comparisons of long versions to determine which
  111. revision is later.
  112.  
  113.     NOTE : If the version stage is 101 (release), the release
  114.            version must be zero.  For example, you may not have
  115.            version 25.0.4 release 16.  "Release version" implies
  116.            that the product is no longer under development and has
  117.            no developmental version numbers.
  118.  
  119.  
  120. SYSTEM VERSION NUMBERS
  121.  
  122. The most important of the numerous version numbers in the system are the
  123. system tool version numbers.  These numbers, passed to LoadTools, LoadOneTool
  124. or StartUpTools ensure that you're getting at least the version you want, or
  125. maybe a later one.  This mechanism is your primary defense against old system
  126. software--by requiring the latest tool versions in your application, you are
  127. notified by the Tool Locator early in your program if the system has the
  128. latest system software installed or not.
  129.  
  130. Note that ROM 1 and ROM 3 have different version numbers for seven tools under
  131. 5.0.4--QuickDraw II, the Scheduler, ADB, SANE, Integer Math, Text Tools and
  132. the List Manager.  In each case, the ROM 01 version is lower and should be
  133. used in your LoadOneTool, LoadTools or StartUpTools calls.
  134. The current revision of Apple IIgs System Software is 6.0.  Assuming a correct
  135. installation, requiring QuickDraw 3.7 in effect requires System Software 6.0,
  136. although you may check the system's rVersion resource in the system resource
  137. file if you require more detailed information about the system sovtware
  138. version.
  139.  
  140. System Tool Set Versions
  141.  
  142. Number     Tool                        ROM 1        ROM 3
  143. 1          Tool Locator                $0301        $0301
  144. 2          Memory Manager              $0302        $0302
  145. 3          Misc Tools                  $0302        $0302
  146. 4          QuickDraw II                $0307        $0307
  147. 5          Desk Manager                $0304        $0304
  148. 6          Event Manager               $0301        $0301
  149. 7          Scheduler                   $0300        $0300
  150. 8          Sound Tools                 $0303        $0303
  151. 9          ADB                         $0300        $0300
  152. 10         SANE                        $0300        $0300
  153. 11         Integer Math                $0300        $0300
  154. 12         Text Tools                  $0300        $0300
  155. 13         [used internally]           $0300        $0300
  156. 14         Window Manager              $0303        $0303
  157. 15         Menu Manager                $0303        $0303
  158. 16         Control Manager             $0303        $0303
  159. 17         [System Loader]             $0400        $0400
  160. 18         QuickDraw II Aux            $0304        $0304
  161. 19         Print Manager               $0301        $0301
  162. 20         Line Edit                   $0303        $0303
  163. 21         Dialog Manager              $0304        $0304
  164. 22         Scrap Manager               $0301        $0301
  165. 23         Standard File               $0303        $0303
  166. 25         Note Synthesizer            $0104        $0104
  167. 26         Note Sequencer              $0104        $0104
  168. 27         Font Manager                $0303        $0303
  169. 28         List Manager                $0303        $0303
  170. 29         ACE                         $0103        $0103
  171. 30         Resource Manager            $0102        $0102
  172. 32         MIDI Tools                  $0103        $0103
  173. 33         Video Overlay               $0103        $0103
  174. 34         Text Edit                   $0103        $0103
  175. 35         MIDI Synth                  $0100        $0100
  176. 38         Media Control               $0100        $0100
  177.  
  178.  
  179. Toolbox Driver Version Numbers
  180.  
  181. Driver                                 Version
  182. ImageWriter II                         4.2
  183. ImageWriter LQ                         4.2
  184. LaserWriter                            3.2
  185. StyleWriter                            1.0
  186. Epson                                  2.0
  187. Printer Port Driver                    2.1
  188. Modem Port Driver                      2.1
  189. Parallel Card Port Driver              2.0
  190. AppleTalk Port Driver                  3.0
  191. Pioneer 4200 (MC)                      1.0
  192. Pioneer 2000 (MC)                      1.0
  193. Apple CD SC (MC)                       1.0
  194.  
  195.  
  196. GS/OS Version Numbers
  197.  
  198. Component                              Version
  199. GS/OS                                  4.1
  200. ProDOS FST                             4.1
  201. AppleShare FST                         4.0
  202. High Sierra FST                        4.0
  203. Character FST                          4.0
  204. DOS 3.3 FST                            1.2
  205. HFS FST                                1.0
  206. Pascal FST                             1.0
  207. AFP Driver                             4.0
  208. Apple II RAMCard driver                1.0
  209. AppleDisk 3.5 Driver                   5.3
  210. AppleDisk 5.25 Driver                  2.5
  211. AppleTalk Main Driver                  4.0
  212. Console Driver                         3.2
  213. RPM Driver                             4.0
  214. SCSI CD Driver                         6.0
  215. SCSI HD Driver                         6.0
  216. SCSI Scanner Driver                    6.0
  217. SCSI Tape Driver                       6.0
  218. UniDisk 3.5 Driver                     3.0
  219.  
  220.  
  221. Control Panel Version Numbers
  222.  
  223. CDev                                   Version
  224. AppleShare                             2.0
  225. Direct Connect Printer                 1.1
  226. FolderPriv                             1.0
  227. General                                2.0
  228. Keyboard                               1.1
  229. Media Control                          1.1
  230. MIDI                                   1.0
  231. Modem Port                             1.1
  232. Monitor                                1.1
  233. Network Printer Namer                  1.0
  234. Network Printer Chooser                1.0
  235. Network                                1.0
  236. Printer Port                           1.1
  237. RAM                                    1.1
  238. SetStart                               1.0
  239. Slots                                  1.2
  240. Sound                                  2.0
  241. Time                                   2.0
  242.  
  243.  
  244. Further Reference
  245. _____________________________________________________________________________
  246.  
  247.    o   Apple IIgs Toolbox Reference
  248.    o   GS/OS Reference
  249.    o   GS/OS Technical Note #1, Contents of System Disk and System Tools
  250.    o   File Type Note for File Type $C7, Control Panel Devices
  251.